package cn.lxb.web.starter.template.controller;

import cn.lxb.web.starter.template.domain.dto.ConvertDTO;
import cn.lxb.web.starter.template.service.BaseService;
import io.swagger.annotations.ApiOperation;
import io.swagger.annotations.ApiParam;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;

import java.util.List;

/**
 * 控制器接口
 *
 * @param <E>  实体对象类型
 * @param <S>  服务接口类型
 * @param <PK> 实体主键类型
 * @author 54lxb
 * @since 2019-11-20
 */
public interface FindController<D, E extends ConvertDTO<D>, S extends BaseService<E, PK>, PK> extends BaseController<E, S> {

    /**
     * 根据主键ID查询对象
     *
     * @param id 主键ID
     * @return 对象
     */
    @ApiOperation("查询详情")
    @GetMapping("/{id}")
    default D findById(@ApiParam(value = "id", required = true) @PathVariable PK id) {
        return getService().selectById(id).toDTO();
    }

    /**
     * 根据搜索参数查询对象列表
     *
     * @return 对象列表
     */
    @ApiOperation("查询列表")
    @GetMapping
    default List<E> findList() {
        return getService().selectList(null);
    }

}
